home *** CD-ROM | disk | FTP | other *** search
/ SGI Freeware 1999 August / SGI Freeware 1999 August.iso / dist / fw_metamail.idb / usr / freeware / catman / u_man / cat1 / mmencode.Z / mmencode
Encoding:
Text File  |  1999-07-16  |  5.0 KB  |  133 lines
  1.  
  2.  
  3.  
  4.      MMMMIIIIMMMMEEEENNNNCCCCOOOODDDDEEEE((((1111))))     BBBBeeeellllllllccccoooorrrreeee PPPPrrrroooottttoooottttyyyyppppeeee ((((RRRReeeelllleeeeaaaasssseeee 1111))))      MMMMIIIIMMMMEEEENNNNCCCCOOOODDDDEEEE((((1111))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.       mimencode - Translate    to and from mail-oriented encoding
  10.       formats
  11.  
  12.       (Same    program    also installed as "mmencode".)
  13.  
  14.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  15.       mmmmiiiimmmmeeeennnnccccooooddddeeee[-u]    [-b] [-q] [-p] [file name] [-o outputfile]
  16.  
  17.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  18.       The _m_i_m_e_n_c_o_d_e    program    simply converts    a byte stream into (or
  19.       out of) one of the standard mail encoding formats defined by
  20.       MIME,    the proposed standard for internet multimedia mail
  21.       formats.  Such an encoding is    necessary because binary data
  22.       cannot be sent through the mail.  The    encodings understood
  23.       by mimencode are preferable to the use of the
  24.       uuencode/uudecode programs, for use in mail, in several
  25.       respects that    were important to the authors of MIME.
  26.  
  27.       By default, mimencode    reads standard input, and sends    a
  28.       "base64" encoded version of the input    to standard output.
  29.  
  30.       The (really not necessary) "-b" option tells mimencode to
  31.       use the "base64" encoding.
  32.  
  33.       The "-q" option tells    mimencode to use the "quoted-
  34.       printable" encoding instead of base64.
  35.  
  36.       The "-u" option tells    mimencode to _d_e_c_o_d_e the    standard input
  37.       rather than encode it.
  38.  
  39.       The "-p" option tells    mimencode to translate decoded CRLF
  40.       sequences into the local newline convention during decoding
  41.       and to do the    reverse    during encoding.  This option is only
  42.       meaningful when  -b (base64 encoding)    is in effect.
  43.  
  44.       If a file name argument is given, input is read from that
  45.       file rather than from    standard input.
  46.  
  47.       The "-o" option, which must be followed by a file name,
  48.       sends    output to the named file rather    than to    standard
  49.       output.
  50.  
  51.      RRRRAAAATTTTIIIIOOOONNNNAAAALLLLEEEE
  52.       _M_i_m_e_n_c_o_d_e is intended    to be a    replacement for    _u_u_e_n_c_o_d_e for
  53.       mail and news    use.  The reason is simple:  uuencode doesn't
  54.       work very well in a number of    circumstances and ways.     In
  55.       particular, uuencode uses characters that don't translate
  56.       well across all mail gateways    (particularly ASCII <->    EBCDIC
  57.       gateways).  Also, uuencode is    not standard --    there are
  58.       several variants floating around, encoding and decoding
  59.       things in different and incompatible ways, with no
  60.  
  61.  
  62.  
  63.      Page 1                          (printed 5/3/99)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      MMMMIIIIMMMMEEEENNNNCCCCOOOODDDDEEEE((((1111))))     BBBBeeeellllllllccccoooorrrreeee PPPPrrrroooottttoooottttyyyyppppeeee ((((RRRReeeelllleeeeaaaasssseeee 1111))))      MMMMIIIIMMMMEEEENNNNCCCCOOOODDDDEEEE((((1111))))
  71.  
  72.  
  73.  
  74.       "standard" on    which to base an implementation.  Finally,
  75.       uuencode does    not generally work well    in a pipe, a lthough
  76.       some variants    have been modified to do so.  Mimencode
  77.       implements the encodings which were defined for MIME as
  78.       uuencode replacements, and should be considerably more
  79.       robust for email use.
  80.  
  81.      SSSSEEEEEEEE AAAALLLLSSSSOOOO
  82.       metamail(1), mailto(1)
  83.  
  84.      BBBBUUUUGGGGSSSS
  85.       This program was originally distributed as "mmencode".  That
  86.       name turns out to conflict with a program of the same    name
  87.       that is part of the Slate software from BBN, but totally
  88.       changing the name to mimencode would create other problems
  89.       (notably with    portability to systems where the left half of
  90.       file names is    limited    to 8 characters).  Currently, it is
  91.       being    distributed with links under BOTH names.  The programs
  92.       in the distribution that call    the program all    call it    as
  93.       "mimencode", so the "mmencode" version may be    deleted    at
  94.       sites    where it causes    a problem.  (The source    files are
  95.       still    named "mmencode" rather    than "mimencode".)
  96.  
  97.      CCCCOOOOPPPPYYYYRRRRIIIIGGGGHHHHTTTT
  98.       Copyright (c)    1991 Bell Communications Research, Inc.
  99.       (Bellcore)
  100.  
  101.       Permission to    use, copy, modify, and distribute this
  102.       material for any purpose and without fee is hereby granted,
  103.       provided that    the above copyright notice and this permission
  104.       notice appear    in all copies, and that    the name of Bellcore
  105.       not be used in advertising or    publicity pertaining to    this
  106.       material without the specific, prior written permission of
  107.       an authorized    representative of Bellcore.  BELLCORE MAKES NO
  108.       REPRESENTATIONS ABOUT    THE ACCURACY OR    SUITABILITY OF THIS
  109.       MATERIAL FOR ANY PURPOSE.  IT    IS PROVIDED "AS    IS", WITHOUT
  110.       ANY EXPRESS OR IMPLIED WARRANTIES.
  111.  
  112.      AAAAUUUUTTTTHHHHOOOORRRR
  113.       Nathaniel S. Borenstein
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.      Page 2                          (printed 5/3/99)
  130.  
  131.  
  132.  
  133.